.TH E1432_GET_ERROR_STRING 3 E1432
.SH NAME
.nf
e1432_get_error_string \- return pointer to last error string
e1432_fill_error_string \- copy last error string to buffer
.fi
.IX e1432_get_error_string(3) 3
.IX e1432_fill_error_string(3) 3
.SH SYNOPSIS
.cS
char *e1432_get_error_string(void)
SHORTSIZ16 e1432_fill_error_string(char *string, SHORTSIZ16 max,
                                   SHORTSIZ16 *actual);
.cE
.SH DESCRIPTION
\fIe1432_get_error_string\fR returns a pointer to a string holding
a one line description of the last error condition.

\fIe1432_fill_error_string\fR returns the same information as
\fIe1432_get_error_string\fR, but it copies it to a passed-in buffer,
instead of returning a pointer to the string.  This works better when
calling from Visual Basic.

\fIstring\fR is a pointer to a buffer allocated by the caller.

\fIlen\fR specifies the size of the \fIstring\fR buffer.  The function
will not write more than this many characters, including the trailing
null, to the \fIstring\fR.

\fIactual\fR points to a value that will be filled in by
\fIe1432_fill_error_string\fR.  The value will be the length of the
string written, not including the trailing null.

.SH EXAMPLE
.cS

    SHORTSIZ16 error;

    error = e1432_set_span(ID, span);
    if (error)
        (void) printf("error: %d %s\n", error, e1432_get_error_string());

.cE
.SH "RESET VALUE"
Not applicable.
.SH "RETURN VALUE"
\fIe1432_get_error_string\fR returns a pointer to the error string.
\fIe1432_fill_error_string\fR returns zero.
.SH "SEE ALSO"
.na
e1432_print_errors
.ad
